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Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
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This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3 GPP and ETSI identities can be found under 
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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document contains an electronic copy of the ANSI-C code for the Adaptive Multi-Rate codec. The ANSI-C 
code is necessary for a bit exact implementation of the Adaptive Multi Rate speech transcoder (TS 26.090 [2]), Voice 
Activity Detection (TS 26.094 [6]), comfort noise (TS 26.092 [4]), source controlled rate operation (TS 26.093 [5]) and 
example solutions for substituting and muting of lost frames (TS 26.091 [3]). 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. 

[1] 3GPP TS 26.074: "AMR Speech Codec; Test sequences". 

[2] 3GPP TS 26.090: "AMR Speech Codec; Speech transcoding". 

[3] 3GPP TS 26.091: "AMR Speech Codec; Substitution and muting of lost frames". 

[4] 3GPP TS 26.092: "AMR Speech Codec; Comfort noise aspects". 

[5] 3GPP TS 26.093: "AMR Speech Codec; Source controlled rate operation". 

[6] 3GPP TS 26.094: "AMR Speech Codec; Voice Activity Detection". 

[7] RFC 3267: "A Real-Time Transport Protocol (RTP) Payload Format and File Storage Format for 

Adaptive Multi-Rate (AMR) and Adaptive Multi-Rate Wideband (AMR-WB) Audio Codecs", 
June 2002. 



3 Definitions and abbreviations 

3.1 Definitions 

Definition of terms used in the present document, can be found in TS 06.090 [2], TS 06.091 [3], TS 06.092 [4], 
TS 06.093 [5] and TS 06.094 [6]. 

3.2 Abbreviations 

For the purpose of the present document, the following abbreviations apply: 

ANSI American National Standards Institute 

ETS European Telecommunication Standard 

GSM Global System for Mobile communications 

I/O Input/Output 

RAM Random Access Memory 

ROM Read Only Memory 
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C code structure 



This clause gives an overview of the structure of the bit-exact C code and provides an overview of the contents and 
organization of the C code attached to this document. 

The C code has been verified on the following systems: 

Sun Microsystems workstations and GNU gcc compiler; 

- DEC Alpha workstations and GNU gcc compiler; 

IBM PC/AT compatible computers with Linux operating system and GNU gcc compiler. 
ANSI-C 9899 was selected as the programming language because portability was desirable. 

4.1 Contents of the C source code 

The C code distribution has all files in the root level. 

The distributed files with suffix "c" contain the source code and the files with suffix "h" are the header files. The ROM 
data is contained mostly in files with suffix "tab". 

The C code distribution also contains one speech coder installation verification data file, "spch_dos.inp". The reference 
encoder output file is named "spch_dos.cod", the reference decoder input file is named "spch_dos.dec" and the 
reference decoder output file is named "spch_dos.out". These four files are formatted such that they are correct for an 
IBM PC/AT compatible computer. The same files with reversed byte order of the 16 bit words are named 
"spch_unx.inp", "spch_unx.cod", "spch_unx.dec" and "spch_unx.out", respectively. 

Final verification is to be performed using the GSM Adaptive Multi-Rate test sequences described in GSM 06.74 [2]. 

Makefiles are provided for the platforms in which the C code has been verified (listed above). Once the software is 
installed, this directory will have a compiled version of encoder and decoder (the bit-exact C executables of the speech 
codec) and all the object files. 

4.2 Program execution 

The GSM Adaptive Multi-Rate codec is implemented in two programs: 

- {encoder) speech encoder; 

- {decoder) speech decoder. 
The programs should be called like: 

- encoder [encoder options] <speech input file> <parameter file>; 

- decoder [decoder options] <parameter file> <speech output file>. 

The speech files contain 16-bit linear encoded PCM speech samples and the parameter files contain encoded speech 
data and some additional flags. 

The encoder and decoder options will be explained by running the applications with option -h. See the file readme.txt 
for more information on how to run the encoder and decoder programs. 
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4.3 Coding style 



The C code is written according to the following structuring conventions. Each function func() that needs static 
variables is considered a module. A module consists of: 

- a 'state structure' (struct) combining the static variables of the module; 

- three auxiliary functions func_init(), func_reset(), and func_exit(); 

- the processing function func() itself. 

The initialization function func_init() allocates (from the heap) a new state structure, calls the func_reset() function, 
stores the pointer to the newly allocated structure in its first function parameter, and returns with a value of if 
completed successful or a value of 1 otherwise. 

The reset function func_reset() takes a pointer to the state structure and resets all members of the structure to a 
predefined value ('homing'). 

The exit function func_exit() performs any necessary cleanup and frees the state structure memory. 

The processing function func() also takes a pointer to the state structure as well as all other necessary parameters and 
performs its task using (and possibly modifying) the values in the state structure. 

If a module calls other modules, the higher level state structure contains a pointer to the lower level state structures, and 
the init, reset, and exit functions recursively call the corresponding lower level functions. 

By this convention, the code becomes "instantiable" (more than one copy of a module can be used in the same program) 
and the static data hierarchy is clearly visible in the code. 



4.4 Code hierarchy 



Figures 1 to 4 are call graphs that show the functions used in the speech codec, including the functions of VAD, DTX, 
and comfort noise generation. 

Each column represents a call level and each cell a function. The functions contain calls to the functions in rightwards 
neighbouring cells. The time order in the call graphs is from the top downwards as the processing of a frame advances. 
All standard C functions: printf(), fwrite(), etc. have been omitted. Also, no basic operations (add(), L_add(), mac(), 
etc.) or double precision extended operations (e.g. L_Extract()) appear in the graphs. The initialization of the static 
RAM (i.e. calling the _init functions) is also omitted. 

The basic operations are not counted as extending the depth, therefore the deepest level in this software is level 7. 

The encoder call graph is broken down into three separate call graphs. Table 1 to 3. 
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Table 1 : Speech encoder call structure 



Speech_Encode_Frame 


Pre Process 










cod_amr 


Copy 




Vadl"" 


filter_bank 


first_filter_stage 




filters 




filters 




level calculation 




vad_decision 


complex estimate adapt 




complex vad 




noise estimate update 


update cntrl 


hangover addition 




Vad2'' 


block_norm 
rjft 

fn10Log10 
Pow2 


cjft 
Log2 










Log2 norm 






tx dtx handler 




Ipc 


Autocorr 




Lag window 




Levinson 




Isp 


Az Isp 


Chebps 




Q_plsf_5 


Lsp Isf 




Lsf wt 




Vq subvec 




Vq subvec s 




Reorder Isf 




Lsf Isp 




Int Ipc lands 2 


Lsp az 


Get Isp pol 


Int Ipc lands 


Lsp az 


Get Isp pol 


Q_plsf_S 


Lsp Isf 




Lsf wt 




Copy 




Vq subvecS 




Vq subvec4 




Reorder Isf 




Lsf Isp 




Int Ipc 1toS 2 


Lsp az 


Get Isp pol 


Int Ipc 1toS 


Lsp az 


Get Isp pol 


Copy 






dtx_buffer 


Copy 




Log2 


Log2 norm 




dtx_enc 


Lsp Isf 






Reorder Isf 




Lsf Isp 




Set zero 






lsp_reset 


Copy 




Q pisf reset 




cl Itp reset 


Pitch fr reset 




check Isp 






pre_big 


Weight Ai 




Residu 




Syn filt 




oljtp 


Pitch_ol 


vad tone detection update^ 




Lag_max 


vad tone detection^ 


Inv sqrt 


comp corr2 




hp max2 




vad complex detection update^ 




Pitch_ol_wgh 


comp corr2 




Lag_max2 


vad tone detection update^ 


vad tone detection^ 


gmed n 




hp max2 




vad complex detection update^ 




vad_pitch_detection 


LTP flag update^ 






subframePreProc 


Weight Ai 




Syn filt 




Residu 




Copy 




cljtp 


Pitchjr 

(continued) 


getRange 




Norm_Corr 


Convolve 


Inv sqrt 


search Frac 


Interpol Sor6 


Enc lags 




Enc lags 











1 option to call one or the other VAD option 

2 Specific to VAD option 1 

3 Specific to VAD option 2 
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Table 1 (concluded): Speech encoder call structure 









Pred It 3or6 


Convolve 


G pitch 


check gp clipping 


q_gain_pitch 


cbsearch 


see Table 2 


gainQuant 


see Table 3 


update gp clipping 


Copy 


subframePostProc 


Syn filt 


Pred It 3or6 




Convolve 




Prm2bits 


Int2bin 





Table 2: cbsearch call structure 



cbsearch 


code_2i40_9bits 


cor h X 




set sign 




cor h 


Inv sqrt 


search 2140 




build code 




code_2i40_1 1 bits 


cor h X 




set sign 




cor h 


Inv sqrt 


search 2i40 




build code 




code 3140 14bits 


cor h X 




set sign 




cor h 


Inv sqrt 


search 3140 




build code 




code_4i40_17bits 


cor h X 




set sign 




cor h 


Inv sqrt 


search 4i40 




build code 




code_8i40_31bits 


cor h X 




set sign12k2 


Inv sqrt 


cor h 


Inv sqrt 


search 10and8i40 




build code 




compress code 


compresslO 


code_1 0i40_35bits 


cor h X 




set sign12k2 


Inv sqrt 


cor h 


Inv sqrt 


search 10and8i40 




build code 




q P 





Table 3: gainQuant call structure 



gainQuant 


gc pred copy 


Copy 






gc_pred 


Log2 


Log2 norm 




Log2 norm 






calc filt energies 






calc target energy 




MR475 update unq pred 


gc pred update 




MR475_gain_quant 


MR475_quant_store_results 


Log2 


Log2 norm | 


gc pred update 




gc_pred 


Log2 


Log2 norm | 


Log2 norm 




G code 








q gain code 


Pow2 




MR795_gain_quant 


q gain pitch 




MR795 gain code quant3 




calc unfilt energies 


Log2 


Log2 norm | 


gain adapt 


gmed n 




MR795 gain code quant mod 


sqrt 1 exp 




Qua gain 


Pow2 






gc pred update 
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Table 4: Speech decoder call structure 



Speech_Decode_Frame 


Bits2prm 


Bin2int 








Decoder_amr 


rx dtx handler 




Decoder_amr_reset 


Isp avg reset 




D pisf reset 




ec gain pitch reset 




ec gain code reset 




gc pred reset 




Bgn scd reset 


Set zero 




ph disp reset 






dtx_dec_reset 


Copy 




Set zero 




dtx_dec 


Copy 






Lsf Isp 




Init D pIsf S 


Copy 




D_plsf_S 


Reorder lsf 




Copy 




Lsf Isp 




pseudonoise 






Lsp lsf 




Reorder lsf 




Lsp Az 


Get Isp pol 




A Refl 






Log2 


Log2 norm 




Build CN code 


pseudonoise 




Syn filt 






Lsf Isp 






Isp avg 




Copy 




D_plsf_3 


Reorder lsf 




Copy 




Lsf Isp 




Int Ipc 1to3 


Lsp Az 


Get Isp pol 




D_plsf_5 


Reorder lsf 






Copy 




Lsf Isp 




Int Ipc lands 


Lsp Az 


Get Isp pol 




Dec lags 








Pred It Sor6 




Dec lags 




decode 2140 9bits 




decode 2i40 11 bits 




decode Si40 14bits 




decode 4140 17bits 




decode 8i40 SI bits 


decompress code 


decompresslO 




ec gain pitch 


gmed n 






d gain pitch 






ec gain pitch update 




decode 10140 SSbits 




Dec_gain 


Log2 


Log2 norm 




gc_pred 


Log2 


Log2 norm | 


Log2 norm 




Pow2 






gc pred update 




ec_gain_code 


gmed n 




gc pred average limeted 




gc pred update 




ec gain code update 






d_gain_code 


gc_pred 


Log2 


Log2 norm | 


Log2 norm 




Pow2 






gc pred update 




Int lsf 






Cb gain average 




ph disp release 




ph disp lock 




ph disp 




sqrt 1 exp 




Ex Ctrl 


gmed n 




agc2 


Inv sqrt 




Syn filt 






Bgn scd 


gmed n 




dtx_dec_activity_update 


Copy 




Log2 


Log2 norm 




Isp avg 








Post_Filter 


Copy 




Weight Ai 




Residu 




Set zero 




Syn filt 




Preemphasis 




age 


energy old 




energy new 


energy old 




Inv sqrt 






Post Process 
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4.5 Variables, constants and tables 

The data types of variables and tables used in the fixed point implementation are signed integers in 2's complement 
representation, defined by: 

- Wordl6 16 bit variable; 

- Word32 32 bit variable. 

Furthermore some enum types are used, all possible to represent with one byte, and a Boolean Flag. 

4.5.1 Description of constants used in the C-code 

This subclause contains a listing of all global constants defined in cnst.h. 

Table 5: Global constants 



Constant 


Value 


Description 


L TOTAL 


320 


total size of speech buffer. 




L WINDOW 


240 


window size in LP analysis 




L FRAME 


160 


frame size 




L FRAME BY2 


80 


frame size divided by 2 




L SUBFR 


40 


subframe size 




L CODE 


40 


codevector length 




NB TRACK 


5 


number of tracks 




STEP 


5 


codebook step size 




NB TRACK MR102 


4 


number of tracks mode mr102 




STEP MR102 


4 


codebook step size mode mr102 




M 


10 


order of LP filter 




MP1 


(M+1) 


order of LP filter + 1 




LSF GAP 


205 


minimum distance between LSF after quantization; 50 Hz = 


= 205 


LSP PRED FAC MR122 


21299 


MR122 LSP prediction factor (0.65 015) 




AZ SIZE 


44 


size of array of LP filters in 4 subframes (4*M+4) 




PIT MIN MR122 


18 


minimum pitch lag (MR122 mode) 




PIT MIN 


20 


minimum pitch lag (all other modes) 




PIT MAX 


143 


maximum pitch lag 




L INTERPOL 


(10+1) 


length of filter for interpolation 




L INTER SRCH 


4 


length of filter for CL LTP search interpolation 




MU 


26214 


factor for tilt compensation filter 0,8 




AGC FAC 


29491 


factor for automatic gain control 0,9 




L NEXT 


40 


overhead in LP analysis 




SHARPMAX 


13017 


maximum value of pitch sharpening 




SHARPMIN 





minimum value of pitch sharpening 




MAX PRM SIZE 


57 


max. num. of params 




MAX SERIAL SIZE 


244 


max. num. of serial bits 




GP CLIP 


15565 


pitch gain clipping = 0.95 




N FRAME 


7 


old pitch gains in average calculation 




EHF MASK 


8 


16 bit representation of all samples in the encoder homing frame (left 






justification) 





4.5.2 Description of fixed tables used in the C-code 

This section contains a listing of all fixed tables sorted by source file name and table name. All table data is declared as 
Wordl6. 
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Table 6: Fixed tables 



File 


Table name 


Length 


Description 


c2_9pf.c 


trackTable 


4*5 


track table for algebraic code book search (MR475, MR515) 


cod_amr.c 


gammal 


10 


spectral expansion factors 


cod_amr.c 


gamma1_12k2 


10 


spectral expansion factors 


cod_amr.c 


gamma2 


10 


spectral expansion factors 


dtx_dec.c 


lsf_hist_mean_scale 


10 


initialization values for DTX Isf parameters 


dtx_dec.c 


dtx_log_en_adjust 


9 


level adjustments for ech mode 


ec_gains.c 


cdown 


7 


attenuation factors for codebook gain 


ec_gains.c 


pdown 


7 


attenuation factors for adaptive codebook gain 


gc_pred.c 


pred 


4 


algebraic code book gain MA predictor coefficients 


gc_pred.c 


pred_MR122 


4 


algebraic code book gain MA predictor coefficients (MR122) 


pitchjr.c 


mode_dep_parm 


72 


parameters defining the adaptive codebook search per mode 


post_pro.c 


a 


3 


HP filter coefficients (denominator) in Post_Process 


post_pro.c 


b 


3 


HP filter coefficients (numerator) in Post_Process 


pre_proc.c 


a 


3 


HP filter coefficients (denominator) in Pre_Process 


pre_proc.c 


b 


3 


HP filter coefficients (numerator) in Pre_Process 


predjt.c 


inter_6 


61 


interpolation filter coefficients 


pstfilt.c 


gamma3_MR122 


10 


spectral expansion factors 


pstfilt.c 


gammas 


10 


spectral expansion factors 


pstfilt.c 


gamma4_MR122 


10 


spectral expansion factors 


pstfilt.c 


gamma4 


10 


spectral expansion factors 


bitno.tab 


prmno 


9 


number of bits for each mode 


bitno.tab 


prmnofsf 


8 


number of parameters for LPC and first subframe for each mode (used for 
decoder homing procedure) 


bitno.tab 


bitno 


9 


pointers to the bitno_MR... tables 


bitno.tab 


bitno_MR475 


17 


number of bits per parameter to transmit (MR475) 


bitno.tab 


bitno MR515 


19 


number of bits per parameter to transmit (MR515) 


bitno.tab 


bitno_MR59 


19 


number of bits per parameter to transmit (MR59) 


bitno.tab 


bitno MR67 


19 


number of bits per parameter to transmit (MR67) 


bitno.tab 


bitno MR74 


19 


number of bits per parameter to transmit (MR74) 


bitno.tab 


bitno MR795 


23 


number of bits per parameter to transmit (MR795) 


bitno.tab 


bitno MR102 


39 


number of bits per parameter to transmit (MR102) 


bitno.tab 


bitno MR122 


57 


number of bits per parameter to transmit (MR122) 


bitno.tab 


bitno_MRDTX 


5 


number of bits per parameter to transmit (MRDTX) 


c2_11pf.tab 


startPosI 


2 


track start search position for first pulse 


c2_1 1 pf .tab 


startPos2 


4 


track start search position for second pulse 


c2_9pf.tab 


startPos 


16 


track start search position 


corrwght.tab 


corrweight 


251 


weighting of the correlation function in open loop LTP search (MR102) 


d_homing.tab 


dhf 


8 


pointers to the dhf_MR... tables 


d_homing.tab 


dhf MR475 


17 


parameter values for the decoder homing frame (MR475) 


d_homing.tab 


dhf MR515 


19 


parameter values for the decoder homing frame (MR515) 


d_homing.tab 


dhf MR59 


19 


parameter values for the decoder homing frame (MR59) 


d_homing.tab 


dhf MR67 


19 


parameter values for the decoder homing frame (MR67) 


d_homing.tab 


dhf MR74 


19 


parameter values for the decoder homing frame (MR74) 


d_homing.tab 


dhf MR795 


23 


parameter values for the decoder homing frame (MR795) 


d_homing.tab 


dhf MR102 


39 


parameter values for the decoder homing frame (MR102) 


d_homing.tab 


dhf_MR122 


57 


parameter values for the decoder homing frame (MR122) 


gains.tab 


qua_gain_pitch 


16 


adaptive codebook gain quantization table (MR122, MR795) 


gains.tab 


qua_gain_code 


96 


fixed codebook gain quantization table (MR122, MR795) 


gray.tab 


gray 


8 


gray coding table 


gray.tab 


dgray 


8 


gray decoding table 


grid.tab 


grid 


61 


grid points at wich Chebyshev polynomials are evaluated 


inter_36.tab 


inter_6 


25 


interpolation filter coefficients 


inv_sqrt.tab 


table 


49 


table used in inverse square root computation 


lag_wind.tab 


lag_h 


10 


high part of the lag window table 


lag wind.tab 


lag 1 


10 


low part of the lag window table 



(continued) 
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Table 6 (concluded): Fixed tables 



File 


Table name 


Length 


Description 


log2.tab 


table 


33 


table used inbase 2 logharithm computation 


Isp.tab 


Isp init data 


10 


initialization table for Isp history in DTX 


Ispjsf.tab 


table 


65 


table to compute cos(x) in LsfJspQ 


Ispjsf.tab 


slope 


64 


table to compute acos(x) in Lspjsf() 


ph_disp.tab 


ph_imp_low_MR795 


40 


phase dispersion impulse response (MR795) 


ph_disp.tab 


ph imp mid MR79 

5 

phjmpjow 


40 


phase dispersion impulse response (MR795) 


ph_disp.tab 


40 


phase dispersion impulse response (MR475 - MR67) 


ph_disp.tab 


ph imp mid 


40 


phase dispersion impulse response (MR475 - MR67) 


pow2.tab 


table 


33 


table used in 2 to the power computation 


q_plsf_3.tab 


past_rq_init 


80 


initialization table for the MA predictor in DTX 


q_plsf_3.tab 


meanjsf 


10 


LSF means (not in MR122) 


q_plsf_3.tab 


predjac 


10 


LSF prediction factors (not in MR122) 


q_plsf_3.tab 


dicoljsf 


3*256 


1'^ LSF quantizer (not in MR122 and MR795) 


q_plsf_3.tab 


dico2_lsf 


3*512 


2"^ LSF quantizer (not in MR122) 


q_plsf_3.tab 


dico3_lsf 


4*512 


3'^ LSF quantizer (not in MR122, MR515 and MR475) 


q_plsf_3.tab 


mr515 3 Isf 


4*128 


3'^ LSF quantizer (MR515 and MR475) 


q_plsf_3.tab 


mr795_1_lsf 


3*512 


1'' LSF quantizer (MR795) 


q_plsf_5.tab 


meanjsf 


10 


LSF means (MR1 22) 


q_plsf_5.tab 


dicoljsf 


4*128 


1'' LSF quantizer (MR1 22) 


q_plsf_5.tab 


dico2Jsf 


4*256 


2"^ LSF quantizer (MR1 22) 


q_plsf_5.tab 


dico3Jsf 


4*256 


3'^ LSF quantizer (MR1 22) 


q_plsf_5.tab 


dico4Jsf 


4*256 


4^' LSF quantizer (MR1 22) 


q_plsf_5.tab 


dico5Jsf 


4*64 


5^' LSF quantizer (MR1 22) 


qgain475.tab 


table_gain_MR475 


4*256 


gain quantization table (MR475) 


qua_gain.tab 


table_gain_highrate 

s 

table_gainJowrates 


128*4 


gain quantization table (MR67, MR74 and MR102) 


qua gain.tab 


64*4 


gain quantization table (MR515 and MR59) 


R fft.c 


phsjbl 


128 


sine/cosine phase table 


RJft.c 


iijable 


8 


indexing table 


sqrt 1 


table 


49 


table to compute sqrt(x) 


Vadl.c 


chjbl 


2*16 


channel energy combination table 


Vadl.c 


chJbLsh 


16 


channel energy scaling table 


Vadl.c 


vmjbl 


90 


voice metric table 


Vadl.c 


hangoverjable 


20 


used to determine hangover as a function of SNR 


Vadl.c 


burstcountjable 


20 


used to determine burst count threshold as a function of SNR 


Vadl.c 


vmjhreshjable 


20 


used to determine the voice metric threshold as a function of SNR 


Vadl.c 


energy state tables 


2*6 


constants as a function of scaling state 


window.tab 


window_200_40 


240 


LP analysis window (not in MR122) 


window.tab 


window_160_80 


240 


1^^ LP analysis window (MR122) 


window.tab 


window 232 8 


240 


2"^ LP analysis window (MR1 22) 



4.5.3 Static variables used in the C-code 

In this section two tables that specify the static variables for the speech encoder and decoder respectively are shown. All 
static variables are declared within a C struct. 
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Table 7: Speech encoder static variables 



Struct name 


Variable 


Type[Length] 


Description 


Speech_Encode_ 


cod_amr_state 


cod_amrState 


see below in this table 


FrameState 










pre state 


Pre ProcessState 


see below in this table 




dtx 


Flag 


Is set if DTX functionality is used 




complexityCounter 


int 


Used for wMOPS counting 


Pre_ProcessState 


y2 hi 


Word 16 


filter state, upper word 




y2 lo 


Word 16 


filter state, lower word 




y1 hi 


Word 16 


filter state, upper word 




y1 lo 


Word 16 


filter state, lower word 




xO 


Word 16 


filter state 




x1 


Word 16 


filter state 


cod_amrState 


old_speech 


Word16[320] 


speech buffer 




speech 


Word 16* 


pointer to current frame in old_speech 




p_window 


Word 16* 


pointer to LPC analysis window in old_speech 




p_window_12k2 


Word 16* 


pointer to LPC analysis window with no lookahead 
in old_speech (MR122) 




new_speech 


Word 16* 


pointer to the last 160 speech samples in 
old_speech 




old_wsp 


Word16[303] 


buffer holding spectral weighted speech 




wsp 


Word 16* 


pointer to the current frame in old_wsp 




oldjags 


Word16[5] 


open loop LTP states 




ol_gain_flg 


Word16[2] 


enables open loop pitch lag weighting (MR102) 




old_exc 


Word16[314] 


excitation vector 




exc 


Word 16* 


current excitation 




ai_zero 


Word16[51] 


history of weighted synth. filter followed by zero 
vector 




zero 


Word 16* 


zero vector 




h1 


Word 16* 


impulse response of weighted synthesis filter 




hvec 


Word16[80] 


zero vector followed by impulse response 




IpcSt 


IpcState 


see below in this table 




IspSt 


IspState 


see below in this table 




cILtpSt 


cILtpState 


see below in this table 




gainQuantSt 


gainQuantState 


see below in this table 




pitchOLWghtSt 


pitchOLWghtState 


see below in this table 




tonStabSt 


tonStabState 


see below in this table 




vadSt 


vadStatel 


see below in this table 




vadSt 


vadState2 


see below in this table 




dtx 


Flag 


is set if DTX functionality is used 




dtx_encSt 


dtx encState 


see below in this table 




mem_syn 


Word16[10] 


synthesis filter memory 




mem_wO 


Word16[10] 


weighting filter memory (applied to error signal) 




mem_w 


Word16[10] 


weighting filter memory (applied to input signal) 




mem_err 


Word16[50] 


filter memory for production of error vector 




error 


Word 16* 


error signal (input minus synthesized speech) 




sharp 


Word 16 


pitch sharpening gain 


vadStatel 


bckr_est 


Word16[9] 


background noise estimate 




avejevel 


Word16[9] 


averaged input components for stationary 
estimation 




oldjevel 


Word16[9] 


input levels of the previous frame 




subjevel 


Word16[9] 


input levels calculated at the end of a frame 
(lookahead) 




a_data5 


Word16[6] 


memory for the filter bank 




a_data3 


Word16[5] 


memory for the filter bank 




burst_count 


Word 16 


counts length of a speech burst 




hang_count 


Word 16 


hangover counter 




stat_count 


Word 16 


stationary counter 




vadreg 


Word 16 


15 flags for intermediate VAD decisions 




pitch 


Word 16 


1 5 flags for pitch detection 




tone 


Word 16 


1 5 flags for tone detection 




complex_high 


Word 16 


flags for complex detection 




complexjow 


Word 16 


flags for complex detection 




oldlag_count 


Word 16 


variables for pitch detection 




oldlag 


Word 16 


variables for pitch detection 




complex_hang_count 


Word 16 


complex hangover counter, used by VAD 



ETSI 



3GPP TS 26.073 version 9.0.0 Release 9 



15 



ETSI TS 126 073 V9.0.0 (2010-01) 



Struct name 


Variable 


Type[Length] 


Description 


vadState2 


complex_hang_timer 

best_corr_hp 

speech_vad_decision 

complex_warning 

sp_burst_count 

corr_hp_fast 

pre_emp_mem 

update_cnt 

hyster_cnt 

last_update_cnt 

ch_enrg_long_db 

Lframe_cnt 

Lch_enrg 

Lch_noise 

last_normb_shift 

tsnr 

hangover 
burstcount 
fupdatejiag 

negSNRvar 

negSNRbias 

shift state 

L_RO 

L Rmax 

LTPJIag 


Word 16 

Word 16 
Word 16 
Word 16 
Word 16 
Word 16 
Word 16 
Word 16 
Word 16 
Word 16 
Word16[16] 
Word32 
Word32[16] 
Word32[16] 
Word 16 

Word 16 
Word 16 
Word 16 
Word 16 

Word 16 
Word 16 
Word 16 
Word32 
Word32 
Flag 


hangover initiator, used by CAD 

filtered value 

final decision 

complex background warning 

counts length of a speech burst inci HO addition 

filtered value 

input pre-emphasis memory 

noise update counter 

hysteresis counter 

noise update counter value for last frame 

long term channel energy in dB 

10 ms frame counter 

channel energy estimate 

channel noise estimate 

block shift factor for last frame, used for 

pre_emp_mem 

total estimated peak SNR in dB 

VAD hangover 

number of consecutive voice active frames 

A flag to control a forced update of the noise 

estimate 

SNR variability 

sensitivity bias 

indicates scaling state of channel energy estimate 

LTP energy 

LTP max correlation 

set when open loop pitch prediction gain > 

threshold 


dtx_encState 


lsp_hist 
log_en_hist 
hist_ptr 
log_en_index 

init_lsf_vq_index 
Ispjndex 

dtxHangoverCount 
decAnaElapsedCount 


Word16[80] 
Word16[8] 
Word 16 
Word 16 

Word 16 
Word16[3] 
Word 16 
Word 16 


LSP history (8 frames) 
logarithmic frame energy history (8 frames) 
pointer to the cyclic history vectors 
Index for logarithmic energy 

initial index for Isf predictor 
Isp indecies to the three code books 
is decreased in DTX hangover period 
counter for elapsed speech frames in DTX 


IpcState 


LevinsonSt 


LevinsonState 


see below 


LevinsonState 


old A 


Word16[11] 


last frames direct form coefficients 


IspState 


lsp_old 

lsp_old_q 

qSt 


Word16[10] 
Word16[10] 
Q pIsfState 


old LSP vector 

old quantized LSP vector 

see below in this table 


Q pIsfState 


past rq 


Word16[10] 


past quantized LSF prediction error 


cILtpState 


pitchSt 


Pitch frState 


see below in this table 


tonStabState 


count 


Word 16 
Word16[7] 


count consecutive (potential) resonance frames 
pitch gain history 


Pitch frState 


TO prev subframe 


Word 16 


integer, pitch lag of previous subframe 


gainQuantState 


sfO_exp_gcodeO 

sfO_frac_gcodeO 

sfO_exp_target_en 

sfO_frac_target_en 

sfO_exp_coeff 

sfO_frac_coeff 

gain_idx_ptr 

gc_predSt 

gc_predUncSt 

adaptSt 


Word 16 
Word 16 
Word 16 
Word 16 
Word16[5] 
Word16[5] 
Word 16* 
gc_predState 
gc_predState 
GainAdaptState 


subframe 0/2 codebook gain exponent 
subframe 0/2 codebook gain fraction 
subframe 0/2 target energy exponent 
subframe 0/2 target energy fraction 
subframe 0/2 energy coefficient exponents 
subframe 0/2 energy coefficient fractions 
pointer to gain index value in parameter frame 
see below in this table 
see below in this table 
see below in this table 


gc_predState 


past_qua_en 
past_qua_en_MR1 22 


Word16[4] 
Word16[4] 


MA predictor memory (20*log10(pred. error)) 
MA predictor memory, 12.2 style (log2(pred. 
error)) 


GainAdaptState 


onset 

prev_alpha 
prev_gc 
ltpg_mem 


Word 16 
Word 16 
Word 16 
Word16[5] 


onset counter 
previous adaptor output 
previous codebook gain 
pitch gain history 
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Struct name 


Variable 


Type[Length] 


Description 


pitchOLWghtState 


old_TO_med 
ada w 


Word 16 
Word 16 


weighted open loop pitch lag 

weigthing level depeding on open loop pitch gain 




wght fig 


Word 16 


switches lag weighting on and off 



Table 8: Speech decoder static variables 



Struct name 


Variable 


Type[Length] 


Description 


Speech_Decode_Fram 


decoder_amrState 


Decoder_amrState 


see below in this table 


estate 










post_state 


Post_FilterState 


see below in this table 




postHP_state 


Post_ProcessState 


see below in this table 




ComplexityCounter 


int 


Used for wMOPS counting 


Decoder_amrState 


old_exc 


Word16[194] 


excitation vector 




exc 


Word 16* 


current excitation 




lsp_old 


Word16[10] 


LSP vector of previous frame 




mem_syn 


Word16[10] 


synthesis filter memory 




sharp 


Word 16 


pitch sharpening gain 




old_TO 


Word 16 


pitch sharpening lag 




prev_bf 


Word 16 


previous value of "bad frame" flag 




prev_pdf 


Word 16 


previous value of "pot. dangerous frame" flag 




state 


Word 16 


ECU state (0..6) 




excEnergyHist 


Word16[9] 


excitation energy history 




TOJagBuff 


Word 16 


received pitch lag for ECU 




inBackgroundNoise 


Word 16 


background noise flag 




voicedHangover 


Word 16 


hangover flag 




ItpGainHistory 


Word16[9] 


pitch gain history 




background_state 


Bgn_scd State 


see below in this table 




Cb_gain_averState 


Cb_gain_averageStat 


see below in this table 




lsp_avg_st 


lsp_avgState 


see below in this table 




IsfState 


D_plsfState 


see below in this table 




ec_gain_p_st 


ec_gain_pitchState 


see below in this table 




ec_gain_c_st 


ec_gain_codeState 


see below in this table 




pred_state 


gc predState 


see table 7 




nodataSeed 


Word 16 


seed for CN generator 




ph_disp_st 


ph_dispState 


see below in this table 




dtxDecoderState 


dtx decState 


see below in this table 


dtx_decState 


since_last_sid 


Word 16 


number of frames since last SID frame 




true_sid_period_inv 


Word 16 


inverse of true SID update rate 




log_en 


Word 16 


logarithmic frame energy 




old_log_en 


Word 16 


previous value of log_en 




L_pn_seed_rx 


Word32 


random number generator seed 




Isp 


Word16[10] 


LSP vector 




Isp old 


Word16[10] 


previous LSP vector 




lsf_hist 


Word16[80] 


LSF vector history (8 frames) 




lsf_hist_ptr 


Word 16 


index to beginning of LSF history 




lsf_hist_mean 


Word16[80] 


mean-removed LSF history (8 frames) 




log_pg_mean 


Word 16 


mean-removed logarithmic prediction gain 




log_en_hist 


Word16[8] 


logarithmic frame energy history 




log_en_hist_ptr 


Word 16 


index to beginning of log, frame energy 
history 




log_en_adjust 


Word 16 


mode-dependent frame energy adjustment 




dtxHangoverCount 


Word 16 


counts down in hangover period 




decAnaElapsedCount 


Word 16 


counts elapsed speech frames after DTX 




sidjrame 


Word 16 


flags SID frames 




valid_data 


Word 16 


flags SID frames containing valid data 




dtxHangoverAdded 


Word 16 


flags hangover period at end of speech 




dtxGlobalState 


enum DTXStateType 


DTX state flags 




data updated 


Word 16 


flags CNI updates 


Bgn_scd State 


frameEnergyHist 


Word16[60] 


history of synthesis frame energy 




bgHangover 


Word 16 


number of frames since last speech frame 



ETSI 



3GPP TS 26.073 version 9.0.0 Release 9 



17 



ETSI TS 126 073 V9.0.0 (2010-01) 



Struct name 


Variable 


Type[Length] 


Description 


Cb_gain_averageState 


cbGainHistory 
hangVar 


Word16[7] 
Word 16 


codebook gain history 

counts length of talkspurt in subframes 




hangCount 


Word 16 


number of subframes since last talkspurt 


Isp avgState 


Isp meanSave 


Word16[10] 


averaged LSP vector 


D_plsfState 


past_r_q 
past Isf q 


Word16[10] 
Word16[10] 


past quantized LSF prediction vector 
past dequantized LSF vector 


ec_gain_pitchState 


pbuf 

past_gain_pit 
prev gp 


Word16[5] 
Word 16 
Word 16 


pitch gain history 

previous pitch gain (limited to 1 .0) 

previous good pitch gain 


ec_gain_codeState 
ph_dispState 


gbuf 

past_gain_code 

prev_gc 

gainMem 

prevState 

prevCbGain 

lockFull 

onset 


Word16[5] 
Word 16 
Word 16 
Word16[5] 
Word 16 
Word 16 
Word 16 
Word 16 


codebook gain history 

previous codebook gain 

previous good codebook gain 

pitch gain history 

previously used impulse response 

previous codebook gain 

force maximum phase dispersion 

onset counter 


Post_FilterState 


res2 

mem_syn_pst 

synth_buf 

agc_state 

preemph_state 


Word16[40] 

Word16[10] 

Word16[170] 

agcState 

preemphasisState 


LP residual 

synthesis filter memory 
synthesis filter work area 
see below in this table 
see below in this table 


agcState 


past gain 


Word 16 


past age gain 


preemphasisState 


mem pre 


Word 16 


filter state 


Post_ProcessState 


y2 hi 
y2 lo 
y1 hi 
y1 lo 
xO 
x1 


Word 16 
Word 16 
Word 16 
Word 16 
Word 16 
Word 16 


filter state, upper word 
filter state, lower word 
filter state, upper word 
filter state, lower word 
filter state 
filter state 



Homing procedure 



The principles of the homing procedures are described in [2] . This specification only includes a detailed description of 
the 8 decoder homing frames. For each AMR codec mode, the corresponding decoder homing frame has a fixed set of 
speech parameters shown in table 9a-9h. The bit allocation within these parameters is identical to the corresponding bit 
allocation of the source encoder output parameters given in [2] . 

In the following tables, the following naming convention is used for the individual parameters. Letters in italics indicate 
numbers. 



hFC_n 
LTP-LAG m 
LTP-GAIN m 
FCB-GAIN m 
GAIN_VQ m 
POS m_n 
POS m_n_k 
POS m_n_k_lj 
SIGN m_n_k 
SIGN m_ n_kJJ 
SlGN_m_n y^_POS_ 



index of ^th LSF submatrix. 
adaptive codebook index for subframe m. 
adaptive codebook gain index in subframe m. 
fixed codebook gain index in subframe m. 

codebook gain VQ index in subframe m (subframe m and m+7 for MR475). 
position index of ^th pulse in subframe m. 
position index of ^th and ^h pulse in subframe m. 
position index of ^th, ^h, /th, andjth pulse in subframe m. 
sign information for ^th and ^h pulse in subframe m. 
sign information for ^th, ^h, /th, and 7th pulse in subframe m. 
m_n sign information for ^th and ^h pulse and position index for ^th pulse in subframe m. 
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Table 9a: Parameter values for the decoder homing frame (MR475) 



Parameter 


Value (LSB=bO) 


LPC1 


OxOOFS 


LPC2 


0x009D 


LPC3 


0x001 C 


LTP-LAG 1 


0x0066 


POS 1 1 2 


0x0000 


SIGN 1 1 2 


0x0003 


GAIN-VQ 1 


0x0028 


LTP-LAG 2 


OxOOOF 


POS 2 1 2 


0x0038 


SIGN 2 1 2 


0x0001 


LTP-LAG 3 


OxOOOF 


POS 3 1 2 


0x0031 


SIGN 3 1 2 


0x0002 


GAIN-VQ 3 


0x0008 


LTP-LAG 4 


OxOOOF 


POS 4 1 2 


0x0026 


SIGN 4 1 2 


0x0003 



Table 9b: Parameter values for the decoder homing frame (MR515) 



Parameter 


Value (LSB=bO) 


LPC1 


0x00F8 


LPC2 


0x009D 


LPC3 


0x001 C 


LTP-LAG 1 


0x0066 


POS 1 1 2 


0x0000 


SIGN 1 1 2 


0x0003 


GAIN-VQ 1 


0x0037 


LTP-LAG 2 


OxOOOF 


POS 2 1 2 


0x0000 


SIGN 2 1 2 


0x0003 


GAIN-VQ 2 


0x0005 


LTP-LAG 3 


OxOOOF 


POS 3 1 2 


0x0037 


SIGN 3 1 2 


0x0003 


GAIN-VQ 3 


0x0037 


LTP-LAG 4 


OxOOOF 


POS 4 1 2 


0x0023 


SIGN 4 1 2 


0x0003 


GAIN-VQ 4 


0x001 F 
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Table 9c: Parameter values for the decoder homing frame (MR59) 



Parameter 


Value (LSB=bO) 


LPC1 


OxOOFS 


LPC2 


0x00E3 


LPC3 


0x002F 


LTP-LAG 1 


OxOOBD 


POS 1 1 2 


0x0000 


SIGN 1 1 2 


0x0003 


GAIN-VQ 1 


0x0037 


LTP-LAG 2 


OxOOOF 


POS 2 1 2 


0x0001 


SIGN 2 1 2 


0x0003 


GAIN-VQ 2 


OxOOOF 


LTP-LAG 3 


0x0060 


POS 3 1 2 


0x00F9 


SIGN 3 1 2 


0x0003 


GAIN-VQ 3 


0x0037 


LTP-LAG 4 


OxOOOF 


POS 4 1 2 


0x0000 


SIGN 4 1 2 


0x0003 


GAIN-VQ 4 


0x0037 



Table 9d: Parameter values for the decoder homing frame (MR67) 



Parameter 


Value (LSB=bO) 


LPC1 


OxOOFS 


LPC2 


0x00E3 


LPC3 


0x002F 


LTP-LAG 1 


OxOOBD 


POS 112 3 


0x0002 


SIGN 112 3 


0x0007 


GAIN-VQ 1 


0x0000 


LTP-LAG 2 


OxOOOF 


POS 2 12 3 


0x0098 


SIGN 2 12 3 


0x0007 


GAIN-VQ 2 


0x0061 


LTP-LAG 3 


0x0060 


POS 3 1 2 3 


0x05C5 


SIGN 3 12 3 


0x0007 


GAIN-VQ 3 


0x0000 


LTP-LAG 4 


OxOOOF 


POS 4 1 2 3 


0x0318 


SIGN 4 12 3 


0x0007 


GAIN-VQ 4 


0x0000 



ETSI 



3GPP TS 26.073 version 9.0.0 Release 9 



20 



ETSI TS 126 073 V9.0.0 (2010-01) 



Table 9e: Parameter values for the decoder homing frame (MR74) 



Parameter 


Value (LSB=bO) 


LPC1 


OxOOFS 


LPC2 


0x00E3 


LPC3 


0x002F 


LIP-LAG 1 


OxOOBD 


POS 112 3 4 


0x0006 


SIGN 112 3 4 


OxOOOF 


GAIN-VQ 1 


0x0000 


LTP-LAG 2 


0x001 B 


POS 2 12 3 4 


0x0208 


SIGN 2 12 3 4 


OxOOOF 


GAIN-VQ 2 


0x0062 


LTP-LAG 3 


0x0060 


POS 3 12 3 4 


0x1 BA6 


SIGN 3 12 3 4 


OxOOOF 


GAIN-VQ 3 


0x0000 


LTP-LAG 4 


0x001 B 


POS 4 12 3 4 


0x0006 


SIGN 4 12 3 4 


OxOOOF 


GAIN-VQ 4 


0x0000 



Table 9f : Parameter values for the decoder homing frame (MR795) 



Parameter 


Value (LSB=bO) 


LPC1 


0x00C2 


LPC2 


0x00E3 


LPC3 


0x002F 


LTP-LAG 1 


OxOOBD 


POS 112 3 4 


0x0006 


SIGN 112 3 4 


OxOOOF 


LTP-GAIN 1 


OxOOOA 


FCB-GAIN 1 


0x0000 


LTP-LAG 2 


0x0039 


POS 2 12 3 4 


0x1 COS 


SIGN 2 12 3 4 


0x0007 


LTP-GAIN 2 


OxOOOA 


FCB-GAIN 2 


OxOOOB 


LTP-LAG 3 


0x0063 


POS 3 12 3 4 


0x1 1A6 


SIGN 3 12 3 4 


OxOOOF 


LTP-GAIN 3 


0x0001 


FCB-GAIN 3 


0x0000 


LTP-LAG 4 


0x0039 


POS 4 12 3 4 


0x09A0 


SIGN 4 12 3 4 


OxOOOF 


LTP-GAIN 4 


0x0002 


FCB-GAIN 4 


0x0001 
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Table 9g: Parameter values for the decoder homing frame (MR102) 



Parameter 


Value (LSB=bO) 


LPC1 


0x00F8 


LPC2 


0x00E3 


LPC3 


0x002F 


LTP-LAG 1 


0x0045 


SIGN 1 1 5 


0x0000 


SIGN 1 2 6 


0x0000 


SIGN 1 3 7 


0x0000 


SIGN 1 4 8 


0x0000 


POS 112 5 


0x0000 


POS 13 6 7 


0x0000 


POS 1 4 8 


0x0000 


GAIN-VQ 1 


0x0000 


LTP-LAG 2 


0x001 B 


SIGN 2 1 5 


0x0000 


SIGN 2 2 6 


0x0001 


SIGN 2 3 7 


0x0000 


SIGN 2 4 8 


0x0001 


POS 2 12 5 


0x0326 


POS 2 3 6 7 


OxOOCE 


POS 2 4 8 


0x007E 


GAIN-VQ 2 


0x0051 


LTP-LAG 3 


0x0062 


SIGN 3 1 5 


0x0000 


SIGN 3 2 6 


0x0000 


SIGN 3 3 7 


0x0000 


SIGN 3 4 8 


0x0000 


POS 3 1 2 5 


0x01 5A 


POS 3 3 6 7 


0x0359 


POS 3 4 8 


0x0076 


GAIN-VQ 3 


0x0000 


LTP-LAG 4 


0x001 B 


SIGN 4 1 5 


0x0000 


SIGN 4 2 6 


0x0000 


SIGN 4 3 7 


0x0000 


SIGN 4 4 8 


0x0000 


POS 4 12 5 


0x01 7C 


POS 4 3 6 7 


0x0215 


POS 4 4 8 


0x0038 


GAIN-VQ 4 


0x0030 
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Table 9h: Parameter values for the decoder homing frame (MR122) 



Parameter 


Value (LSB=bO) 


LPC1 


0x0004 


LPC2 


0x002A 


LPC3 


OxOODB 


LPC4 


0x0096 


LPC5 


0x002A 


LTP-LAG 1 


0x0156 


LTP-GAIN 1 


OxOOOB 


SIGN 1 1 6 POS 1 1 


0x0000 


SIGN 1 2 7 POS 1 2 


0x0000 


SIGN 1 3 8 POS 1 3 


0x0000 


SIGN 1 4 9 POS 1 4 


0x0000 


SIGN 1 5 10 POS 1 5 


0x0000 


P0S1 6 


0x0000 


P0S1 7 


0x0000 


P0S1 8 


0x0000 


P0S1 9 


0x0000 


P0S1 10 


0x0000 


FCB-GAIN 1 


0x0000 


LTP-LAG 2 


0x0036 


LTP-GAIN 2 


OxOOOB 


SIGN 2 1 6 POS 2 1 


0x0000 


SIGN 2 2 7 POS 2 2 


OxOOOF 


SIGN 2 3 8 POS 2 3 


OxOOOE 


SIGN 2 4 9 POS 2 4 


OxOOOC 


SIGN 2 5 10 POS 2 5 


OxOOOD 


POS 2 6 


0x0000 


POS 2 7 


0x0001 


POS 2 8 


0x0005 


POS 2 9 


0x0007 


POS 2 10 


0x0001 


FCB-GAIN 2 


0x0008 


LTP-LAG 3 


0x0024 


LTP-GAIN 3 


0x0000 


SIGN 3 1 6 POS 3 1 


0x0001 


SIGN 3 2 7 POS 3 2 


0x0000 


SIGN 3 3 8 POS 3 3 


0x0005 


SIGN 3 4 9 POS 3 4 


0x0006 


SIGN 3 5 10 POS 3 5 


0x0001 


POS 3 6 


0x0002 


POS 3 7 


0x0004 


POS 3 8 


0x0007 


POS 3 9 


0x0004 


POS 3 10 


0x0002 


FCB-GAIN 3 


0x0003 


LTP-LAG 4 


0x0036 


LTP-GAIN 4 


OxOOOB 


SIGN 4 1 6 POS 4 1 


0x0000 


SIGN 4 2 7 POS 4 2 


0x0002 


SIGN 4 3 8 POS 4 3 


0x0004 


SIGN 4 4 9 POS 4 4 


0x0000 


SIGN 4 5 10 POS 4 5 


0x0003 


POS 4 6 


0x0006 


POS 4 7 


0x0001 


POS 4 8 


0x0007 


POS 4 9 


0x0006 


POS 4 10 


0x0005 


FCB-GAIN 4 


0x0000 
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6 File formats 

This section describes the file formats used by the encoder and decoder programs. The test sequences defined in [1] also 
use the file formats described here. 

6.1 Speech file (encoder input / decoder output) 

Speech files read by the encoder and written by the decoder consist of 16-bit words where each word contains a 13-bit, 
left aligned speech sample. The byte order depends on the host architecture (e.g. MSByte first on SUN workstations, 
LSByte first on PCs etc.). Both the encoder and the decoder program process complete frames (of 160 samples) only. 

This means that the encoder will only process n frames if the length of the input file is n^l60 + k words, while the files 
produced by the decoder will always have a length of n^ 160 words. 

6.2 Mode control file (encoder input) 

The encoder program can optionally read in a mode control file which specifies the encoding mode for each frame of 
speech processed. The file is a text file containing one line per speech frame. Each line contains one of the mode names 
from the list {MR475, MR515, MR59, MR67, MR74, MR795, MR102, MR122}. 

6.3 Parameter bitstream file (encoder output / decoder input) 

The files produced by the speech encoder/expected by the speech decoder contain an arbitrary number of frames in the 
following format. 



FRAME_TYPE 


Bl 


B2 


... 


B244 


MODE_INFO 


unusedl 


... 


unused4 



Each box corresponds to one Wordl6 value in the bitstream file, for a total of 250 words or 500 bytes per frame. The 
fields have the following meaning: 

FRAME_TYPE transmit frame type, which is one of 

TX_SPEECH (0x0000) 

TX_SID_FIRST (0x0001) 

TX_SID_UPDATE (0x0 02) 

TX NO DATA (0x0003) 



B0...B244 



speech encoder parameter bits (i.e. the bitstream itself). Each Bx either has the 
value 0x0000 or Oxoooi. Only mode MR122 really uses all 244 bits; for the other 

modes, only the first n bits are used (35 < n < 204). The remaining bits are unused 
(written as Oxoooo) 



MODE_iNFO encoding mode information, which is one of 

MR475 (0x0000) 

MR515 (0x0001) 

MR59 (0x0002) 

MR67 (0x0003) 

MR74 (0x0004) 

MR795 (0x0005) 

MR102 (0x0006) 

MR122 (0x0007) 

unusedL.A unused, written as OxOOOO 

As indicated in section 6.1 above, the byte order depends on the host architecture. 
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By using a preprocessor definition the encoder output and decoder input can optionally use format described in [7], 
sections 5.1 and 5.3. 
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Annex A (informative): 
Change History 



SIVIG 

# 


Tdoc SMG 


Spec 


CR 


Cat 


PH 


Vers 


New 
Version 


Subject 


SA6 SP-99560 26.073 , 






3.0.0 Approved at TSG-SA#6 


SA7 SP-000025 26.073 


001 


A R99 3.0.0 


3.1 .0 Avoidance of pulse cancellation in FCB excitation 


SA11 


SP-010100 


26.073 


003 


A 


R99 


3.1.0 


3.2.0 


Correction of potential bug in AMR decoder due to 
usage of standard C abs() function 


SA11 


SP-010100 


26.073 


005 


A 


R99 


3.1.0 


3.2.0 


Correction of comfort noise parameter interpolation bug 
of AMR decoder 


SA11 


SP-010100 


26.073 


007 


A 


R99 


3.1.0 


3.2.0 


Correction of mode state bug in AMR decoder 


SA11 


SP-010100 26.073 


009 


A 


R99 


3.1.0 


3.2.0 


Correction of TX TYPE and RX TYPE identifiers 


SA11 


SP-010100 


26.073 


Oil 


A 


R99 


3.1.0 


3.2.0 


Correction of potential bug in AMR decoder due to the 
usage of standard C abs() function (VAD option_2) 


SA11 SP-010100 


26.073 


004 


A 


Rel-4 


3.1.0 


4.0.0 


Correction of potential bug in AMR decoder due to 
usage of standard C abs() function 


SA11 


SP-010100 


26.073 


006 


A 


Rel-4 


3.1.0 


4.0.0 


Correction of comfort noise parameter interpolation bug 
of AMR decoder 


SA11 


SP-010100 


26.073 


008 


A 


Rel-4 


3.1.0 


4.0.0 


Correction of mode state bug in AMR decoder 


SA11 SP-010100 26.073 


010 


A Rel-4 3.1.0 4.0.0 


Correction of TX TYPE and RX TYPE identifiers 


SA11 


SP-010100 26.073 


012 


A 
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3.1.0 


4.0.0 


Correction of potential bug in AMR decoder due to the 
usage of standard C abs() function (VAD option_2) 


SA14 


SP-010696 


26.073 


014 


A 


Rel-4 


4.0.0 


4.1.0 


Correction of RX-DTX handling of NO_DATA frames in 
AMR decoder 


SA14 


SP-010697 


26.073 


016 


A 


Rel-4 4.0.0 4.1.0 


Correction in AMR decoder to avoid division by zero in 
RX-DTX Handling 


SA16 


1 




Rel-5 4.1.0 5.0.0 


Version for Release 5 


SA19 


SP-030085 26.073 


017 


Rel-5 5.0.0 5.1.0 MMS compatible input/output option 


SA21 


SP-030444 


26.073 


018 




Rel-5 


5.1.0 


5.2.0 


Correction of the MMSJO flag 
Note. The following line (missing in the approved CR) 
was added for the ANSI-C code to compile correctly: 
+const char sp_enc_id[] = "@(#)$ld $" sp_enc_h; 


SA23 


SP-040197 26.073 


019 




Rel-5 


5.2.0 


5.3.0 


Correction of AMR DTX functionality 


SA26 


1 






Rel-6 


5.3.0 


6.0.0 


Version for Release 6 


SA36 


SP-070321 26.073 


0020 


1 


Rel-7 6.0.0 7.0.0 Bit order of Mode Indication in AMR comfort noise 
frames 
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7.0.0 


8.0.0 


Version for Release 8 


SA46 
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9.0.0 


Version for Release 9 
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